home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / utils / filup605.zip / FILUPDAT.DOC < prev    next >
Text File  |  1996-05-30  |  6KB  |  147 lines

  1. FILUPDAT.DOC                         1                         Revised: 05/30/96
  2.  
  3. Introduction:
  4.  
  5. This program is designed to make updating of files and source code  both  easier
  6. and quicker.  It compares a list of files in a source directory  to  a  list  of
  7. files in a destination directory and copies any files that are  newer  than  the
  8. ones found in the destination directory.  This is quicker than  copying  all  of
  9. the files with DOS wildcard commands and cleaner than  copying  everything  when
  10. you only want some of the files in the destination area.
  11.  
  12.  
  13. The control card file:
  14.  
  15. FILUPDAT requires an ASCII control card file to be created.   The  control  card
  16. file can consist of five types of records:
  17.  
  18. (1)  comments:  These records start with semi-colons or  colons  or  are  blank.
  19.      They are available primarily for documenting what you're doing.
  20.  
  21. (2)  source directory:  These records start  with  "-S"  (or  "-F"  for  "from")
  22.      followed by the path to copy the files from.   Something  like  "-SC:\QB45"
  23.      works fine.
  24.  
  25. (3)  destination directory:  These records start with "-D" (or  "-T"  for  "to")
  26.      followed  by   the   path   to   copy   the   files   to.    For   example,
  27.      "-DJ:\EBBNEW\DOCS".
  28.  
  29. (4)  exclusion specification:  These records start with "-X" followed by a space
  30.      and one or more filespecs (typically with wildcards).   For  example,  your
  31.      main file specification may be "*.*" but you  can  exclude  any  QuickBASIC
  32.      source code files or  object  modules  by  including  a  "-X  *.BAS  *.OBJ"
  33.      statement.
  34.  
  35. (5)  files:  These records have a single file name (e.g.  "EBBFFILE.WP") that is
  36.      to be copied from the source directory to the destination directory.   File
  37.      specifications can include standard DOS wildcards ("*" and "?").  A comment
  38.      can follow the file name provided the comment starts  with  a  colon  or  a
  39.      semi-colon.
  40.  
  41.  
  42. FILUPDAT.DOC                         2                         Revised: 05/30/96
  43.  
  44. Source and destination cards can be changed throughout the  control  card  file.
  45. Files are copied based on the most recent  source/destination  card  before  the
  46. file card.  Changing either the source or destination will reset  the  exclusion
  47. specification so you have to respecify the -X card if desired.
  48.  
  49. Also note that cards are processed sequentially.   The  exclusion  specification
  50. card only affects file name card(s) which occur after it.
  51.  
  52.  
  53. A sample control card file might look like this:
  54.  
  55.         ; Sample file
  56.         -SC:\PDOX
  57.         -DJ:\EBBNEW\PRGS
  58.         CUSTOM.SC
  59.         ADDRESS.SC
  60.         ZIPCODE.SC
  61.         ; Specifying another source file path; destination still the same
  62.         -SC:\MINE
  63.         NEWUSER.SC
  64.  
  65.  
  66. Specifying parameters:
  67.  
  68. Parameters for this program can be set in the following ways.  The last  setting
  69. encountered always wins:
  70.   - Read from an *.INI file (see BRUCEINI.DOC file),
  71.   - Through the use of an environmental variable (SET FILUPDAT=whatever), or
  72.   - From the command line (see "Syntax" below)
  73.  
  74.  
  75.  
  76. FILUPDAT.DOC                         3                         Revised: 05/30/96
  77.  
  78. Syntax:
  79.  
  80.     FILUPDAT { ctlfile | /Cctlfile }
  81.       [ /Flist_file [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] ]
  82.       [ /FULL ] [ /ALL ] [ /ERROR | /-ERROR ] [ /Q ] [ /Iinitfile | /-I ] [ /? ]
  83.  
  84. where:
  85.  
  86. "ctlfile" or "/Cctlfile" is the name of the  control  statement  file.   It  can
  87. include path information if necessary.
  88.  
  89. "/Flist_file" says you want a text file created which tells you what files  were
  90. considered and what happened to each of them.  The "list_file" is  the  name  of
  91. the file.  This is primarily used for checking the operation of the utility. The
  92. file name can include path information if necessary.
  93.  
  94. "/OVERWRITE" says that if the list_file  already  exists,  don't  prompt  before
  95. overwriting it.
  96.  
  97. "/APPEND" says to append to the list_file if it already exists.
  98.  
  99. "/-OVERWRITE" says to abort if the output file exists already.
  100.  
  101. "/OVERASK" says to prompt if the  output  file  exists  already.   This  is  the
  102. default.
  103.  
  104. "/FULL" says to write out full comparison information in the list_file.  This is
  105. primarily for debugging purposes but it includes the numeric  representation  of
  106. the date and time for both the source and destination files.
  107.  
  108. "/ALL" says to copy all files in your ctlfile regardless of relative ages.
  109.  
  110. "/ERROR" says that if any source or destination subdirectory is missing, give an
  111. error message and abort the program.  This is initially the default.
  112.  
  113. "/-ERROR" says that if any source or destination subdirectory is  missing,  give
  114. an error message but continue processing.
  115.  
  116. "/Q" turns off the file-by-file status reporting.
  117.  
  118. "/Iinitfile" says to read an initialization file with the file name  "initfile".
  119. The file specification *must* contain a period.  Initfiles are described in  the
  120. BRUCEINI.DOC file.  Initially defaults to "/IFILUPDAT.INI".
  121.  
  122. "/-I" (or "/INULL") says to skip loading the initialization file.
  123.  
  124. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  125.  
  126.  
  127. FILUPDAT.DOC                         4                         Revised: 05/30/96
  128.  
  129. Author:
  130.  
  131.                         Bruce Guthrie
  132.                         Room H-4885
  133.                         U.S. Dept of Commerce/ESA/STAT-USA
  134.                         Washington, DC 20230
  135.  
  136.                         voice: (202) 482-3234
  137.                         e-mail: bguthrie@doc.gov
  138.  
  139. You may freely copy and re-distribute this program; however, the U.S. Department
  140. of Commerce neither guarantees nor assures compatibility of the program with all
  141. computer software or hardware.
  142.  
  143. Foreign users:  Please provide an Internet e-mail address in all correspondence.
  144.  
  145.  
  146. 
  147.